quarto website

with magick

Author

Tony Duan

1 Publishcation

1.1 Publish quarto website into quarto hub

you need to have quarto pub account https://quartopub.com/

Code

quarto publish quarto-pub

1.2 Publish quarto website into github page

1.2.1 change _quarto.yml

_quarto.yml

#| eval: false
project:
  type: website
  output-dir: docs

1.2.2 add a `.nojekyll` file to the root of your repository

tells GitHub Pages not to do additional processing of your published site using Jekyll (the GitHub default site generation tool):

Mac/Linux	Terminal `touch .nojekyll`
Windows	Terminal `copy NUL .nojekyll`

1.2.3 create github repository

1.2.4 in github repository setting/Pages change branch to mian /docs

The github site is created: https://your_github_name.github.io/repository_name/

1.2.5 ignore some file to be upload to github

In mac using {shift+command+.} to show hidden .gitignore file

for example,add *.parquet in .gitignore file to ignore all parquet file

Code

.gitignore

.Rproj.user
.Rhistory
.RData
.Ruserdata

/.quarto/

*.parquet

---
title: "quarto website"
subtitle: "with magick"

author: "Tony Duan"

execute:
  warning: false
  error: false
  eval: false
  
format:
  html:
    toc: true
    toc-location: right
    code-fold: show
    code-tools: true
    number-sections: true
    code-block-bg: true
    code-block-border-left: "#31BAE9"
    code-copy: true
---





# Publishcation

## Publish quarto website into quarto hub

you need to have quarto pub account https://quartopub.com/

```{r}
#| eval: false
quarto publish quarto-pub
```

## Publish quarto website into github page


### change \_quarto.yml

``` {.python filename="_quarto.yml"}
#| eval: false
project:
  type: website
  output-dir: docs
```


### add a `.nojekyll` file to the root of your repository

tells GitHub Pages not to do additional processing of your published site using Jekyll (the GitHub default site generation tool):

+---------------+---------------------------------+
| Mac/Linux     | ``` {.bash filename="Terminal"} |
|               | touch .nojekyll                 |
|               | ```                             |
+---------------+---------------------------------+
| Windows       | ``` {.bash filename="Terminal"} |
|               | copy NUL .nojekyll              |
|               | ```                             |
+---------------+---------------------------------+


### create github repository

![](images/12.png)

### in github repository setting/Pages change branch to mian /docs

![](images/13.png)



The github site is created: https://your_github_name.github.io/repository_name/


### ignore some file to be upload to github

In mac using {shift+command+.} to show hidden `.gitignore` file

for example,add \*.parquet in .gitignore file to ignore all parquet file

``` {python filename=".gitignore"}
#| eval: false
.Rproj.user
.Rhistory
.RData
.Ruserdata

/.quarto/

*.parquet
```